Deployment of .NET apps to Raspberry Pi is identical to that of any other platform. Your app can run as self-contained or framework-dependent deployment modes. There are advantages to each strategy. For more information, see .NET application publishing overview.

To deploy your app as a framework-dependent app, complete the following steps:

Ensure SSH is enabled on your Raspberry Pi. If needed, refer to Setting up an SSH Server in the Raspberry Pi documentation.

Install .NET on the Raspberry Pi using the dotnet-install scripts. Complete the following steps from a Bash prompt on the Raspberry Pi (local or SSH):

Run the following command to install .NET:

Note

This installs the latest version. If you need a specific version, replace the --channel STS parameter with --version , where is the specific build version.

To simplify path resolution, add a DOTNET_ROOT environment variable and add the .dotnet directory to $PATH with the following commands:

Verify the .NET installation with the following command:

Verify the displayed version matches the version you installed.

Publish the app on the development computer as follows, depending on development environment.

Using an SFTP client like scp, copy the files from the publish location on the development computer to a new folder on the Raspberry Pi.

For example, to use the scp command to copy files from the development computer to your Raspberry Pi, open a command prompt and execute the following:

Where:

Tip

Recent versions of Windows have OpenSSH, which includes scp, pre-installed.

From a Bash prompt on the Raspberry Pi (local or SSH), run the app. To do this, set the deployment folder as the current directory and execute the following command (where HelloWorld.dll is the entry point of the app):

To deploy your app as a self-contained app, complete the following steps:

Ensure SSH is enabled on your Raspberry Pi. If needed, refer to Setting up an SSH Server in the Raspberry Pi documentation.

Publish the app on the development computer as follows, depending on development environment.

If using Visual Studio, deploy the app to a local folder. Before publishing, select Edit in the publish profile summary and select the Settings tab. Ensure that Deployment mode is set to Self-contained and Target runtime is set to linux-arm64.

If using the .NET CLI, use the dotnet publish command with the --runtime linux-arm64 and --self-contained arguments:

Important

If you're using a 32-bit OS, you need to target the linux-arm runtime.

Using an SFTP client like scp, copy the files from the publish location on the development computer to a new folder on the Raspberry Pi.

For example, to use the scp command to copy files from the development computer to your Raspberry Pi, open a command prompt and execute the following:

Where:

Tip

Recent versions of Windows have OpenSSH, which includes scp, pre-installed.

From a Bash prompt on the Raspberry Pi (local or SSH), run the app. To do this, set the current directory to the deployment location and complete the following steps:

Give the executable execute permission (where HelloWorld is the executable file name).

Run the executable.